#include <stdio.h>

/*
 * int snprintf(char* dest_str,size_t size,const char* format,…)
 *
 * 将可变个参数(...)按照format格式化成字符串，然后将其复制到str中。
 *
 * (1) 如果格式化后的字符串长度 < size，则将此字符串全部复制到str中，并给其后添加一个字符串结束符('\0')；
 *
 * (2) 如果格式化后的字符串长度 >= size，则只将其中的(size-1)个字符复制到str中，
 *     并给其后添加一个字符串结束符('\0')，返回值为欲写入的字符串长度。
 *
 * 若成功则返回预写入的字符串长度，若出错则返回负值。
 * 与snprintf的返回值不同，sprintf的返回值是成功写入的字符串长度，此处需要谨慎处理
 *
 * strcpy() sprintf() strcat() 存在安全隐患， 其对应的安全版为：
 * strncpy() snprintf() strncat()
 *
 * snprintf(s,100,"%.*S",3,"abcd");
 * s的值为abc
 * %.*s 表示有两项， 第一项指定了长度，第二项则是%s的内容，所以取前三位
 */

/* command length */
#define BT_INSTRUCTION_LEN  64

/* 串口设置指令:AT+UART=<波特率>,<数据位>,<停止位>,<校验位>,<超时时间>{CR}{LF} */
#define BT_SET_UART "AT+UART=%d,%d,%d,%d,%d\r\n"


int BluetoothSetUart(void) 
{
    char pAtInstruction[BT_INSTRUCTION_LEN] = { 0 };

    snprintf(pAtInstruction, sizeof(pAtInstruction), BT_SET_UART, 115200, 8, 1, 0, 50);
    printf("%s\n", pAtInstruction);

    return 0;
}

int main () 
{
    char a[16];
    size_t i;
 
    i = snprintf(a, 13, "%012d", 12345);  // 第 1 种情况
    printf("i = %lu, a = %s\n", i, a);    // 输出：i = 12, a = 000000012345
 
    i = snprintf(a, 9, "%012d", 12345);   // 第 2 种情况
    printf("i = %lu, a = %s\n", i, a);    // 输出：i = 12, a = 00000001
                                          // warning:指令输出被截断，将12个字节写入大小为9的区域
                                          // note:将13个字节输出到大小为9的目的地

    BluetoothSetUart();
 
    return 0;
}
